/*
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
package org.schema.domain.thing.intangible;

import java.util.Date;
import org.schema.domain.Thing;
import org.schema.domain.thing.Intangible;
import org.schema.domain.thing.Organization;
import org.schema.domain.thing.Product;
import org.schema.domain.thing.creativeWork.Review;
import org.schema.domain.thing.intangible.enumeration.ItemAvailability;
import org.schema.domain.thing.intangible.enumeration.OfferItemCondition;
import org.schema.domain.thing.intangible.rating.AggregateRating;

/**
 * An offer to sell an item—for example, an offer to sell a product, the DVD of a movie, or tickets to an event.
 */
public interface Offer extends Intangible {

	/**
	 * The overall rating, based on a collection of reviews or ratings, of the item.
	 *
 	 * @return AggregateRating
	 */
	AggregateRating getAggregateRating();

	/**
	 * The overall rating, based on a collection of reviews or ratings, of the item.
	 *
 	 * @param aggregateRating
	 * @return void
	 */
	void setAggregateRating(AggregateRating aggregateRating);

	/**
	 * The availability of this item—for example In stock, Out of stock, Pre-order, etc.
	 *
 	 * @return ItemAvailability
	 */
	ItemAvailability getAvailability();

	/**
	 * The availability of this item—for example In stock, Out of stock, Pre-order, etc.
	 *
 	 * @param itemAvailability
	 * @return void
	 */
	void setAvailability(ItemAvailability itemAvailability);

	/**
	 * The condition of the item for sale—for example New, Refurbished, Used, etc.
	 *
 	 * @return OfferItemCondition
	 */
	OfferItemCondition getItemCondition();

	/**
	 * The condition of the item for sale—for example New, Refurbished, Used, etc.
	 *
 	 * @param offerItemCondition
	 * @return void
	 */
	void setItemCondition(OfferItemCondition offerItemCondition);

	/**
	 * The item being sold.
	 *
 	 * @return Product
	 */
	Product getItemOffered();

	/**
	 * The item being sold.
	 *
 	 * @param product
	 * @return void
	 */
	void setItemOffered(Product product);

	/**
	 * The offer price of the product.
	 *
 	 * @return Thing
	 */
	Thing getPrice();

	/**
	 * The offer price of the product.
	 *
 	 * @param thing
	 * @return void
	 */
	void setPrice(Thing thing);

	/**
	 * The currency (in 3-letter ISO 4217 format) of the offer price.
	 *
 	 * @return String
	 */
	String getPriceCurrency();

	/**
	 * The currency (in 3-letter ISO 4217 format) of the offer price.
	 *
 	 * @param string
	 * @return void
	 */
	void setPriceCurrency(String string);

	/**
	 * The date after which the price is no longer available.
	 *
 	 * @return Date
	 */
	Date getPriceValidUntil();

	/**
	 * The date after which the price is no longer available.
	 *
 	 * @param date1
	 * @return void
	 */
	void setPriceValidUntil(Date date1);

	/**
	 * Review of the item.
	 *
 	 * @return Review
	 */
	Review getReviews();

	/**
	 * Review of the item.
	 *
 	 * @param review
	 * @return void
	 */
	void setReviews(Review review);

	/**
	 * The seller of the product.
	 *
 	 * @return Organization
	 */
	Organization getSeller();

	/**
	 * The seller of the product.
	 *
 	 * @param organization
	 * @return void
	 */
	void setSeller(Organization organization);

}